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Preface 


This installation guide contains instructions on how to install Release 1.4 of the operating system. It 
assumes that you are familiar with the Paragon™ system and system administration. 

If you have just received your Paragon system, the operating system, tools, and SATs are already 
installed. You may still, however, need to configure the Paragon supercomputer for your network 
and to configure a paging tree. This guide explains how to perform those tasks. 

For more detailed information about system configuration, refer to the Paragon ™ System 
Administrator’s Guide . For more information about the Paragon system, refer to the Paragon system 
documentation set and the online manual pages. 


Organization 

Chapter 1 Provides background information that you should know before beginning the 

system software installation. 

Chapter 2 Provides instructions on how to install the operating system. 

Notational Conventions 


This manual uses the following notational conventions: 

Bold Identifies command names and switches, system call names, reserved words, 

and other items that must be used exactly as shown. 

Italic Identifies variables, filenames, directories, processes, user names, and writer 

annotations in examples. Italic type style is also occasionally used to 
emphasize a word or phrase. 
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Plain-Monospace 

Identifies computer output (prompts and messages), examples, and values of 
variables. Some examples contain annotations that describe specific parts of 
the example. These annotations (which are not part of the example code or 
session) appear in italic type style and flush with the right margin. 

Bold-Italic-Monospace 

Identifies user input (what you enter in response to some prompt). 

Bold-Monospace 

Identifies the names of keyboard keys (which are also enclosed in angle 
brackets). A dash indicates that the key preceding the dash is to be held down 
while the key following the dash is pressed. For example: 

<Break> <s> <Ctrl-Alt-Del> 

[ ] (Brackets) Surround optional items. 

(Ellipses) Indicate that the preceding item may be repeated. 

| (Bar) Separates two or more items of which you may select only one. 

{ } (Braces) Surround two or more items of which you must select one. 

Applicable Documentation 

For information about the manuals shipped with the Paragon system, see the Paragon™System 
Technical Documentation Guide. 
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Comments and Assistance 


Intel Scalable Systems Division is eager to hear of your experiences with our products. Please call 
us if you need assistance, have questions, or otherwise want to comment on your Paragon system. 


U.S.A./Canada Intel Corporation 
Phone: 800-421-2823 
Internet: support@ssd.intel.com 


France Intel Corporation 

1 Rue Edison-BP303 

78054 St. Quentin-en-Yvelines Cedex 

France 

0590 8602 (toll free) 


Intel Japan K.K. 

Scalable Systems Division 
5-6 Tokodai. Tsukuba City 
Ibaraki-Ken 300-26 
Japan 

0298-47-8904 


United Kingdom Intel Corporation (UK) Ltd. 
Scalable Systems Division 

Pipers Way 
Swindon SN3 IRJ 
England 

0800 212665 (toll free) 

(44) 793 491056 
(44) 793 431062 
(44) 793 480874 
(44) 793 495108 

Germany Intel Semiconductor GmbH 

Dornacher Strasse 1 

85622 Feldkirchen bei Muenchen 

Germany 

0130 813741 (toll free) 


World Headquarters 
Intel Corporation 
Scalable Systems Division 
15201 N.W. Greenbrier Parkway 
Beaverton, Oregon 97006 
U.S.A. 

(503) 677-7600 (Monday through Friday, 8 AM to 5 PM Pacific Time) 
Fax:(503)677-9147 


If you have comments about our manuals, please fill out and mail the enclosed Comment Card. You 
can also send your comments electronically to the following address: 

techpubs@ssd.intel.com 

(Internet) 
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Pre-Installation Information 



Introduction 


This chapter provides some background information necessary for installing the Release 1.4 
operating system software on the Paragon™ System hardware. 

This chapter describes typesetting conventions in addition to those in the Preface, lists the disk space 
requirements for the system software, and lists information about your system that you need to 
gather before beginning installation. 

The chapter also gives instructions on how to verify the required hardware and software 
configuration files. To verify the software configuration files, you must power up the Paragon 
system and log into the diagnostic station. 

The chapter lists the directories and files recommended for backup before you begin the installation. 
A typical backup procedure is described. Finally, the chapter describes node numbering schemes. 


Typesetting and Other Conventions 

The procedures in this chapter use the conventions described in the Preface. You should also be 

aware of the following conventions: 

• The instruction TEnter character(s)” means type the indicated character(s), and then press the 
<Enter> key. For example, “Enter/’ means type the letter y, and then press the <Enter> 
key. 

• In prompts, square brackets surround a default value. Pressing <Enter> selects the indicated 
default value. 

• Some steps in these procedures cause a great deal of information to be displayed. However, the 
steps as described here may show only the last message displayed. Also, do not be concerned if 
the indicated message does not appear immediately. Some steps take several minutes to 
complete. 
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Disk Space Requirements 

Software: Paragon Software Release 1.4 
Installed on Paragon System hardware 
Size: 95M bytes 

Software: Paragon Boot Software Release 1.4 
Installed on the diagnostic station 
Size: 8M bytes 

The boot software on the diagnostic station requires 8.0M bytes. However, using the diagnostic 
station to store tar files during installation requires additional temporary space of about 150M bytes. 


Information Needed for Installation 

To perform the installation, you need to log in as root to the diagnostic station, so you will need the 
root password on the diagnostic station. 

During the installation, you will be prompted for the following information: 

Paragon system host name (also called the network name): 

Paragon system Internet address: 

Paragon system disk type: 

This is one of the following: raid3, maxtor76, maxtor!240, Igb, 4gbraid3, 16gbraid3pfspg. 
Netmask address for your installation: 

Broadcast address for your installation: 

Gateway address for your installation: 

Network time server for your installation: 

You will also need network information about the system where you store the distribution files (the 
tar files on the distribution tapes). This system may be the diagnostic station. 

Host name of the server with distribution files: 

Internet address of the server with distribution files: 

Path of the directory containing the distribution files: 

Valid login name and password on the distribution server: 
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Verifying Required Hardware 

Before performing any of the installation steps, verify the following information: 

• Verify that there is an ethernet connection from both the diagnostic station and from the Paragon 
system boot node to your local network. This is needed to transfer the installation files. 

• Verify that there is a serial line from the boot node to the diagnostic station. This line is needed 
for the Paragon system console interface. 


Powering Up the Paragon™ System Hardware 

The Paragon system hardware must be powered up before you can install the operating system. Use 
the following procedure if the system is not already powered up: 

1. Locate the circuit breakers at the bottom on the back of each cabinet. 

If the circuit breakers are already up, there's no need to cycle them. Once the breakers are on, 
they should not be turned off. 

If the breakers are down (off), flip them up—starting with cabinet 0 and proceeding in 
numerical order through the rest of the cabinets. Cabinet 0 is the cabinet containing the 
diagnostic station, and is the leftmost cabinet when viewed from the back or the rightmost when 
viewed from the front. 

2. Power on the diagnostic station. 

A. The diagnostic station is located in cabinet 0, which is the rightmost cabinet when facing 
the cabinets from the front. Open the front door of this cabinet and swing out the diagnostic 
station. 

B. Turn on the power switch located on the back of the diagnostic station. 

3. Open the back door of any cabinet. Notice the green power control board with red LEDs. This 
board has three white buttons on its upper-right corner. 

A. Press the bottom button to shut down power to the nodes. 

B. Wait about ten seconds for the disks to spin down and then press the top button to power 
up the nodes. 
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Logging into the Diagnostic Station 

When the diagnostic station is powered up and in multiuser mode, log in as root. You can log in 
directly to the diagnostic station, or you can rlogin to the diagnostic station from another system on 
the network. 

When you log directly into the diagnostic station, you have a choice to use either the Open Desk Top 
or the virtual terminal facility. 

• Using the Open Desk Top (ODT). It is not necessary to run the Open Desk Top (ODT) on the 
diagnostic station. If you choose to do so, enter the following command: 

DS# startx 

To create another window with the ODT, use the left mouse button to click on the root window 
and select “New Window” from the menu. 

The mouse has a trackball for cursor movement. The top button is considered to be the left 
button; the bottom button is the right. Use the mouse to switch between windows. 

• Using the virtual terminal facility. If you choose to use the virtual terminal facility, use 
<Alt-Fl> and <Alt-F2> to switch between windows. 

<Alt-Fl> Puts you in the default window. This is the original window and is 
referred to as the diagnostic window. 

<Alt-F2> Switches to what will be referred to as the console window. 


Verifying Configuration Files on the Diagnostic Station 

The MAGIC.MASTER , DEVCONF.TXT , and MAGIC.md files must be in the boot directory 
(normally /usr/paragon/boot) on the diagnostic station. 

The SYSCONFIG.TXT file is automatically created during installation. An existing 
SYSCONFIG.TXT is saved as SYSCONFIG.OLD. Also, a SYSC0NF1G.BIN file is created or 
overwritten in the diagnostic directory, /u/paragon/diag. This is a hardcoded path inside initutil, so 
SYSCONFIG.BIN should not be moved. 


DEVCONF.TXT 


The DEVCONF.TXT file that describes the configuration of the devices on the Paragon system. It 
contains one entry for each device in the system. This file must be in the boot directory (normally 
/usr/paragon/boot). 
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The following is an example of a typical DEVCONF.TXT file: 

DEVICES 
ENET 00D03 


TAPE 

00D03 

ID 

5 

DAT 











TAPE 

00D03 

ID 

6 

DAT 











TAPE 

00C01 

ID 

6 

DAT 











RAID 

00A01 

ID 

0 

SW 3.06 

LV 

3 

DC 

5 

SID 

0 

RAID3 




RAID 

00B01 

ID 

0 

SW 3.06 

LV 

3 

DC 

5 

SID 

0 

RAID3 CTRLO 

PAGE. 

jro 

rzOb 

RAID 

00B01 

ID 

0 

SW 3.06 

LV 

3 

DC 

5 

SID 

0 

RAID3 CTRL1 

PAGE. 

_TO 

rzOb 

RAID 

00C01 

ID 

0 

SW 3.06 

LV 

3 

DC 

5 

SID 

0 

RAID3 




RAID 

00D03 

ID 

0 

SW 3.06 

LV 

3 

DC 

5 

SID 

0 

RAID3 




RAID 

01A12 

ID 

0 

SW 3.06 

LV 

3 

DC 

5 

SID 

0 

RAID3 




RAID 

01B12 

ID 

0 

SW 3.06 

LV 

3 

DC 

5- 

SID 

0 

RAID3 





MIO 00A01 H04 
SIO 00B01 H04 
MIO 00C01 H04 
MIO 00D03 H04 
MIO 01A12 H04 
MIO 01B12 H04 
HIPPI 00A05 H04 
END_DEVICES 

Note the two lines with the keywords CTRLO and CTRL1. These identify the two channels on a 
SCSI-16 controller. CTRLO indicates channel 0, and CTRL1 indicates channel 1. CTRLO is the 
default and need not be specified. 

The PAGEJTO partition identifies the partition used for paging. The default is rzOb, which need not 
be specified. The PAGEJTO rzOb is shown to indicate how you would specify a paging partition, 
but, even though it is the default, rzOb is used as the example because it is the partition most 
commonly used for paging. 

This file should already exist on your diagnostic station. Refer to the Paragon ™ System Commands 
Reference Manual for more information about the format of this file. 


MAGIC.MASTER 

The reset script uses the MAGIC.MASTER file, which must contain the following lines: 

BOOT__FIRST_NODE=boot_node 
BOOT_CONSOLE=cm 
BOOT_GREEN_LED=Dci 
BOOT_RED_LED=Dcg1 
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In this listing, bootjiode is an integer that uses the OS node numbering method to identify the boot 
node. The BOOT_CONSOLE string can be set to f to specify the fscan console interface or to cm 
to specify the async console interface using the serial port, cm is the default. 

You can control the operation of the reset script by defining strings in MAGlC.MASTER . This 
facility exists to minimize the editing of the reset script itself. A variable in the reset script 
effectively gets a new value if you define a string in MAGlC.MASTER with RST_ prepended to the 
variable name. For example, to change the value of the variable SERIAJLJDEVICE in the reset 
script, you can define RST_SERIAL_DEVICE in MAGlC.MASTER. 

However, do not set BOOT_VMJPAGESIZE to any value in MAGlC.MASTER. Nor should 
BOOTJVMJPAGESIZE be explicitly set in MAGIC.md. BOOT_VM_PAGESIZE gets its value 
from the reset script. Edit the reset script directly when changing BOOTJVM J>AGESIZE. If you 
use a SCSI-8 board as a bootnode, the reset script must define BOOTJVMJPAGESIZE to be 4096. 
If you use a SCSI-16 (SIO board) board as a bootnode, the reset script must define 
BOOTVM_PAGESIZE to be 8192. 

The strings RST_CONFIGURATION and RSTjTOPjBACKPLANE follow slightly different 
rules. The corresponding variables CONFIGURATION and TOPJ3ACKPLANE are not defined in 
the reset script. If RST_CONFIGURATION and RSTJTOPJ3ACKPLANE are not defined in 
MAGlC.MASTER, reset calls another utility that calculates the appropriate values from the 
hardware configuration. If the calculated values differ from the defaults (CONFIGURATION = full 
and TOPJBACKPLANE = D), a message prints on the screen that displays the new values. If 
CONFIGURATION and TOP_BACKPLANE are defined in the reset script, their values are 
ignored. 

Sometimes for debugging purposes, you may want to define a configuration that is different from 
your actual hardware. You would do this by editing SYSC0NF1G.TXT. You can remove an entire 
backplane by deleting the lines specifying its configuration or identifying its slots as EMPTY. If you 
do either, you must specify the new configuration with RST_CONFIGURATION and 
RSTjTOPjBACKPLANE. If RST_CONFIGURATION and RSTJTOPJ3ACKPLANE are not 
present, the reset script will determine the real hardware configuration, not the made-up one in 
SYSC0NF1G.TXT. 

When you execute the reset script with the ramdisk option, it uses the MAGIC.md file instead of 
MAGlC.MASTER. MAGIC.md must contain at least the following lines: 

REAL_F IRS T__NODE=3 
BOOT jROOT J.DEV=md 0 a 

Ensure that in this file, REAL_FIRST_NODE is equal to the BOOT_FIRSTjNODE value in 
MAGlC.MASTER. As in the MAGlC.MASTER file, MAGIC.md uses the OS node numbering 
method. The exception is BOOTJFIRSTJ^ODE in MAGIC.md , which does not follow a numbering 
scheme and must be 0. NUM_BUFFERS=10 is the default and need not be explicitly set. 
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Backing Up 

Before you begin the installation, you should back up any directories and files on your Paragon 
system that you want to keep. 

Normally you would back up files by copying them to a tape in the DAT drive. For example, to back 
up /home on a DAT tape, log into the Paragon system, insert a DAT tape into the drive, and issue 
the following command: 

# dump -0 -£ /dev/ioO/rmt€ -c /home 

The DAT device name is rmt6 on the Paragon system. 

Consider backing up the following files and directories on the Paragon system: 

/etc/TIMEZONE 

/etc/bootmesh. log (for your records-do NOT restore on the new system) 
/etc/devtab 

/etc/ f stab (for comparison-do NOT restore on the new system) 

/etc/pf stab (for comparison-do NOT restore on the new system) 

/etc/group 

/etc/hippi.conf 

/etc/hosts 

/etc/hosts.equiv 

/etc/networks 

/etc/passwd 

/etc/phones-file 

/etc/printcap 

/etc/profile 

/etc/remote-file 

/etc/resolv.conf 

/etc/rc.config 

/sbin/init.d/inet 

/etc/services 

/etc/shells 

/etc/uucp • 

/home (user accounts) 

/usr / local (or whatever local directories you have) 

/usr/spool/macs 
/usr/spool/nqs 
/var/adm/acct 
/var/adm/cron/at.allow 
/var/adm/cron/at.deny 
/var/adm/cron/cron.allow 
/var/adm/cron/cron.deny 
/var/adm/sendmail/aliases 
/var/adm/sendmail/sendmail.cf 
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/var/adm/wtmp (for your records-do NOT restore on the new system) 

/var/spool /cron/crontabs (root's crontah is overwritten when new software is 
installed; User crontab files need only be saved if the root filesystem is recreated or 
reformatted.) 

/var/spool/mail 

Also, you might want to save the output from a last command for your history records. 

You may also want to save the reset script in /usr/paragon/boot on the diagnostic station. You 
may have previously edited this reset script so that a default paging tree will be automatically 
generated. Installing Paragon system software overwrites the reset script—as it should, because 
the reset script is software belonging to the new release and may have been updated as part of 
the release. However, you may want to compare the old and new reset scripts if you want to 
configure automatic paging tree generation by editing your new reset script. 


Understanding Node Numbering 

There are two node numbering schemes on the Paragon system: CBS (Cabinet:Backplane:Slot) 
numbering and OS numbering (also called root partition numbering). 

You should become familiar with both schemes, because you will encounter them both. For 
example, the SYSC0NF1G.TXT file uses CBS numbering because it is primarily a hardware 
configuration file, and the MAGIC.MASTER file uses OS numbering because it is primarily a 
software configuration file. 


CBS Numbering 


To identify a node with CBS numbering, you specify its cabinet, backplane, and slot. The following 
display shows the first few lines of an example SYSCONF1G. TXT file, which illustrates how the CBS 
numbers are used: the first entry indicates cabinet 0, the BP indicates backplane D, and the multiple 
S’s indicate slots 0 through 15. 


CABINET 0 
PC AP04 
LED AB14 


BP A AD00 
S 0 EMPTY 


s 

1 

MPNODE 

AGOO 

64 

MRC 

04 

NIC 

B02 

s 

2 

EMPTY 







s 

3 

EMPTY 







s 

4 

MPNODE 

AGOO 

64 

MRC 

04 

NIC 

B02 

s 

5 

MPNODE 

AGOO 

64 

MRC 

04 

NIC 

B02 

s 

6 

MPNODE 

AGOO 

64 

MRC 

04 

NIC 

B02 

s 

7 

MPNODE 

AGOO 

64 

MRC 

04 

NIC 

B02 


MIO 


H04 CTRLO 


RAID3 
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S 8 MPNODE AGOO 64 MRC 04 NIC B02 
S 9 MPNODE AGOO 64 MRC 04 NIC B02 
S 10 MPNODE AGOO 64 MRC 04 NIC B02 
S 11 MPNODE AGOO 64 MRC 04 NIC B02 
S 12 MPNODE AGOO 64 MRC 04 NIC B02 
S 13 MPNODE AGOO 64 MRC 04 NIC B02 
S 14 MPNODE AGOO 64 MRC 04 NIC B02 
S 15 MPNODE AGOO 64 MRC 04 NIC B02 


Cabinets 

Cabinet numbering begins with cabinet 0 which is the right-most cabinet as viewed from the front. 

Backplanes 

There are up to four backplanes in a cabinet. The backplanes are identified alphabetically, starting 
with A at the bottom. Each backplane consists of up to 16 nodes, which are arranged linearly in slots. 

Slots 

When the nodes are viewed from the front, the slot numbering starts at the right of the card cage and 
moves left. To find the LED associated with a slot, you begin counting at the lower-right corner of 
the backplane’s block of LEDs, count up the right column, and then over to the next column to the 
left, and then back down in a serpentine fashion; that is, Slot 0 is the lower-right LED, and Slot 15 
is the lower-left LED. 

The following shows how the slots in a single backplane map to the LEDs in the cabinet door. The 
physical layout of slots in card cage is as follows (front view). (The <perf> indicates the empty 
performance monitor slot.) 

15 14 13 12 11 10 9 8 <perf> • 7 6 5 4 3 2 1 0 

The mesh arrangement of slots is shown on LED panel like this (front view): 

12 11 4 3 

13 10 5 2 

14 9 6 1 

15 8 7 0 
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OS Numbering 

OS numbering starts at the top left of the left-most cabinet and spans all of the cabinets. When you 
reach the end of the right-most cabinet, return to the left-most cabinet, drop down a row, and 
continue counting. OS node numbering is also called root partition node numbering. 

The following shows the OS numbers and the CBS numbers for all the nodes in a two-cabinet system 
(as seen when facing the LEDS). A row of LEDs is represented by two rows of numbers. The top 
row of numbers contains the OS numbers and the bottom row contains the CBS numbers. For 
example the node with an OS number of 21 has a CBS number of 0D09. 


Cabinet 

1 


i 


Cabinet 

0 




0 

1 

2 

3 

i 

4 

5 

6 

7 

OS number 


1D12 

1D11 

1D04 

1D03 

l 

0D12 

0D11 

0D04 

0D03 

CBS number 


8 

9 

10 

11 


12 

13 

14 

15 



1D13 

1D10 

1D05 

1D02 

I 

0D13 

0D10 

0D05 

0D02 



16 

17 

18 

19 

i 

20 

21 

22 

23 

Backplane 

D 

1D14 

1D09 

1D06 

1D01 

l 

0D14 

0D09 

0D06 

0D01 



24 

25 

26 

27 

l 

28 

29 

30 

31 



1D15 

1D08 

1D07 

1D00 

I 

0D15 

0D08 

0D07 

0D00 



32 

33 

34 

35 

I 

36 

37 

38 

39 



1C12 

1C11 

1C04 

1C03 

i 

0C12 

0C11 

0C04 

0C03 



40 

41 

42 

43 


44 

45 

46 

47 



1C13 

1C10 

1C05 

1C02 

i 

0C13 

0C10 

0C05 

0C02 



48 

49 

50 

51 

I 

52 

53 

54 

55 

Backplane 

C 

1C14 

1C 09 

1C06 

1C01 

I 

0C14 

0C09 

0C06 

0C01 



56 

57 

58 

59 

I 

60 

61 

62 

63 



1C15 

1C08 

1C07 

1C00 

l 

0C15 

0C08 

0C07 

0C00 



64 

65 

66 

67 

I 

68 

69 

70 

71 



1B12 

1B11 

1B04 

1B03 

I 

0B12 

0B11 

0B04 

0B03 



72 

73 

74 

75 

I 

76 

77 

78 

79 



1B13 

1B10 

1B05 

1B02 

l 

0B13 

0B10 

0B05 

0B02 



80 

81 

82 

83 

i 

84 

85 

86 

87 

Backplane 

B 

1B14 

1B09 

1B06 

1B01 

I 

0B14 

0B09 

0B06 

0B01 



88 

89 

90 

91 

I 

92 

93 

94 

95 



1B15 

1B08 

1B07 

IB 00 

I 

0B15 

0B08 

0B07 

0B00 



96 

97 

98 

99 

I 

100 

101 

102 

103 



1A12 

1A11 

1A04 

1A03 

l 

0A12 

0A11 

0A04 

0A03 



104 

105 

106 

107 

l 

108 

109 . 

110 

111 



1A13 

1A10 

1A05 

1A02 

I 

0A13 

0A10 

0A05 

0A02 



112 

113 

114 

115 

I 

116 

117 

118 

119 

Backplane 

A 

1A14 

1A09 

1A06 

1A01 

I 

0A14 

0A09 

0A06 

0A01 



120 

121 

122 

123 

I 

124 

125 

126 

127 



1A15 

1A08 

1A07 

1A00 

I 

0A15 

0A08 

0A07 

0A00 
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Software Installation 
and Configuration 



Introduction 


This chapter describes how to install the Release 1.4 operating system software on the Paragon 
system hardware. 

Upgrading from a previous release is similar to the complete installation, except that you may be 
able to skip some of the configuration steps. For example, the configuration of additional I/O nodes 
is preserved from the previous installation unless you are adding new hardware or choose to rebuild 
the root file system. 

Before performing any installation, you may wish to consult with either your regional or on-site Intel 
Parallel Systems engineer to discuss specific installation issues relating to your system. 


2-1 





Software Installation 


Paragon™ System Software Release 1.4 Installation Guide 


Installing the Software 

Before installing the operating system software, install the diagnostic software. Refer to the 
Paragon System Diagnostic D1AG2.0.1 Release Notes for information about how to install 
diagnostic software. 

• . Installation Time. Approximately 2 hours for the complete update from Release 1.3 to Release 

1.4. 

• Installation Medium. The system software is provided on three 0.25-inch QIC 150 cartridge 
tapes. In some special cases, installation tar files are transferred from SSD via ftp. 

Paragon™ System Software Release 1.4 

boot.tar Contains all the utilities for booting operating system from the diagnostic 

station as well as operating system diagnostic binaries and debugging 
tools. 

root.tar Contains all the commands that are installed on the root partition. 

usr.tar Contains all the commands that are installed on the /usr partition. 

mach_svr.tar Contains the microkernel, initialization, and server files. 

doc.tar.Z Contains online manual pages and PostScript copies of manuals for the 

operating system. 

Paragon™ System ParAide Software Release 1.4 

tools,tar.Z Contains the development tools for the Paragon™ System. 

crstools.tar.Z Contains the cross-development tools for the Paragon™ System. 
tools.doc. tar.Z Contains a PostScript copies of tools manuals. 

Paragon™ .System SAT Software Release 1.4 

sat.tar.Z Contains the System Acceptance Tests source and binaries. 

sat.doc.tar Contains a PostScript copy of the Paragon™ System Acceptance Test 
User’s Guide. 
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NOTE 

These instructions assume that SCO UNIX and the SCO Open 
Desktop are installed on the diagnostic station. If this software is 
not installed, contact Intel SSD Customer Support. 


Obtaining the Instaiiation Files from Tape 

If you have the installation files on one or more tapes, copy the files on each tape to the diagnostic 
station. These files go into the /uJtmp directory. 

Do not copy the files into /tmp. If you put the tar files into /tmp, you risk filling up your root partition. 
You may choose instead to copy the tar files to one of your local servers. 

1. Change to the directory where the distribution files will be stored: 

DS# cd /u /tmp 

2. Insert the distribution tape into the cartridge tape drive. Several installation tapes are provided. 
These release notes describe the installation of software on the following tapes: 

• Paragon ™ System Software Release 1.4 , which contains the Paragon System operating 
system. 

• Paragon™ System ParAide Software Release 1.4 which contains the native and 
cross-development tools. These include the IPD debugger, application profiling, 
even-driven profiling, and SPV, a system utilization monitor. 

• Paragon ™ SAT Software Release 1.4 which contains the System Acceptance Tests. 

Compilers appear on additional tapes and their installation is described in their accompanying 
release notes. If you are also planning to install compilers at this time, you may want to read in 
those tapes as well. The postboot script described later in this chapter allows you to choose the 
installation of the native compilers; but you should consult the compiler release notes for 
complete information. The compiler release notes contain instructions on how to install the 
cross compilers. 

3. Use the tar command to copy the files from the distribution tape. The device name of the 
cartridge tape drive on the diagnostic station is rStpO. 

DS# tar xvfp /dev/rStpO 

After the files have been copied, remove the tape from the cartridge tape drive. 

4. Remove the distribution tape from the cartridge tape drive. 

5. Repeat steps 2 through 4 for as many distribution tapes as you want to read in. 
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Installing Boot Files on the Diagnostic Station 

The following instructions assume that you are logged in as root to the diagnostic station. 

1. If you copied the distribution files from a tape into the /u/tmp directory on the diagnostic station, 
proceed to the next step. 

If the distribution files are stored on some other server, you need to use ftp to copy the boot, tar 
file to /u/tmp. This file requires about 8M bytes of storage. When you invoke ftp, it will prompt 
you for a login name and password on the distribution server. 

DS# cd /u/tmp 

DS# ftp IP Address of sender with distribution files 

Name: login_name 

Password: password 

ftp> cd path to distribution files 

ftp> bin 

ftp> get boot.ter 

ftp> bye 

2. Change to the / directory, and use tar to extract the files from boot.tar: 


CAUTION 

Ensure that no one is using any of the utilities from 
/usr/paragon/bin when you untar boot.tar. If someone is using a 
utility when you untar boot.tar, that utility will not be updated. 


CAUTION 

Many sites backup boot software by moving directories to another 
name. If you do this, untarring boot.tar will create directories. 
Unless you set your umask appropriately, the permissions on 
these directories will be wrong, and the Paragon system will not 
boot. 


DS# cd / 

DS# umask 022 

DS# tar xvfp /u/tmp/boot.tar 
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CAUTION 

Before running buildscan, install the diagnostic software. Refer to 
the Paragon 7 System Diagnostic DIAG2.0.1 Release Notes for 
information about how to install diagnostic software. This software 
contains the scan driver that buildscan will build. Note that if the 
software is distributed via ftp rather than tape, the diagnostic 
software is in the file diag.tar. 


3. Modify the .profile file: 

DS# cd / 

edit the .profile file and change the line: 

PATH=$PATH:$HOME/bin:/usr/local/bin:. 
to 

PATH=$PATH:$HOME/bin:/usr/paragon/bin:/usr/local/bin:. 

See Changes in File Location in the Paragon ™ System Software Release 1.4 Release Notes for 
more information regarding this path change. 

4. If you are upgrading from Release 1.3, you must relink the kernel on the diagnostic station. To 
relink the kernel, issue the following commands: 

DS# cd /etc/conf/pack.d/sc&n 
DS# ./buildscan 

This command takes a few minutes to rebuild the UNIX Operating System. Answer y to the 
questions. The first question confirms that you want to rebuild the kernel. The next asks if you 
want the new kernel to boot by default. The last question asks if you want the kernel 
environment rebuilt. Then, when the DS# prompt returns, reboot. 

DS# init 6 

Note that the command, init 6 is equivalent to the command, shutdown -y -gO -i6. Installation 
instructions for other products may use this alternate version. 

If you are working directly at the diagnostic station, wait for the : (colon) prompt, and then 
press the <Enter> key. 

If you are remotely logged into the diagnostic station, the init 6 closes the connection and 
you will need to rlogin again after waiting a few minutes. You can use ping to detect if the 
diagnostic station is ready to be logged into. 

When the login prompt appears, log in as root. 
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5. Ensure that the following variables are defined correctly in /etc/default/tcp: 

DOMAIN= 

NETMASK= 

BROADCAST= 

6. Verify that the /etc/hosts file contains the two aliases: PARALALIAS and DIAG^ALIAS. This 
modification needs to be performed only once during the first installation. 

• The PARALALIAS alias identifies the IP address of the Paragon system. 

• The DIAG_.ALIAS alias identifies the IP address of the machine where the kernel, ramdisk, 
and bootmagic files exist. This machine is usually the diagnostic station. 

Here is an example of the two lines as they might appear in /etc/hosts. 

xxx .yy. zzz. a ds ds.abc.def.com DIAG_ALIAS #diagnostic station 
xxx.yy.zzz .ab paragon PARALALIAS #Paragon system 

7. If the diagnostic station’s and the Paragon system’s IP address and system network name are 
not what you want, change the diagnostic station’s IP address and system network name in the 
file /etc/hosts to the values for your installation. You should have values for the diagnostic 
station, the Paragon system, and loopback. 

A. Issue the uname command, specifying the new system name. 

DS# uname -5 <new system name> 

B. Change to the directory /etc/conf/cfd and run configure. 

DS# cd /etc/conf/cf . d 
DS# ./configure 

C. A menu appears. Choose System Name and type in the new system name. 

D. Link in a new kernel. This step is only necessary if you changed the system name. Your 
current directory is still /etc/conf/cf d. 

DS# .Zlink_unix 

E. Reboot the diagnostic station. Answer y to all questions. There’s a silent wait here of a few 
minutes. Press any key when requested. 

DS# init 6 

There still remains some network configuration to be performed on the Paragon system after the 
operating system software is installed. Refer to “Configuring the Paragon™ System for the 
Network” on page 2-25 for this information. 
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Installing the Operating System Software 

1. Ensure that the DEVCONF. TXT file in /usr/paragon/boot is present and correct. Refer to the 
Paragon ™ System Commands Reference Manual for information about how to set up this file. 

Note that if you have a SCSI-16 controller with two SCSI channels, this must be identified in 
DEVCONF. TXT. 

RAID 00B01 ID 0 SW 3.06 LV 3 DC 5 SID 0 RAID3 CTRLO 
RAID 00B01 ID 0 SW 3.06 LV 3 DC 5 SID 0 RAID3 CTRL1 

The keyword CTRLn designates either SCSI channel 0 or channel 1. CTRLO is the default and 
need not be specified. 

2. If your site uses the network queueing system (NQS), stop all NQS queues before installing the 
operating system. This prevents NQS from starting up on the reboot immediately after the 
operating system installation. Refer to the Paragon System Network Queueing System Manual 
for complete information about how to stop and start NQS queues. 

For example, to stop an NQS queue called q 16-30, become root on the Paragon system, enter 
the NQS qmgr, and issue the stop queue command. 

# qmgr 

Mgr: stop queue ql6-30 

NQS manager[TCML__COMPLETE ] : Transaction complete at local host. 

If you are upgrading from Release 1.3 to Release 1.4, you must convert the NQS queues file. 
You can do this by running the NQS setup script or running the nqs_queue_upgrade command 
manually. Do either after completing the installation of the operating system. 

Once the NQS queues file has been updated, restart the queues you have stopped. To do this, 
enter the NQS qmgr, and issue the start queue command. 

Mgr: start queue ql6-30 

NQS manager[TCML_COMPLETE ] : Transaction complete at local host. 

3. Reset the Paragon system using the reset command with the autocfg option. The reset script is 
located in /usr/paragon/boot. For information about the reset command, refer to the Paragon ™ 
System Commands Reference Manual. 

When executed with the autocfg option, the reset script creates the file SYSCONFIG. TXT in the 
current directory and SYSCONFIG.BIN in the diagnostic directory /u/paragon/diag. A previous 
version of SYSCONFIG. TXT is saved as SYSCONF1G.OLD. 
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DS# cd /usr/paragon/boot 
DS# ./reset autocfg 


-> Automatic SYSCONFIG.TXT generation. 

How many cabinets are there? [1] number of cabinets 
Generating /u/paragon/diag/hwconfig.txt... 

Generating SYSCONFIG.TXT... 

SYSCONFIG.TXT has been created. 

Generating SYSCONFIG.BIN... 

Using MAGIC.MASTER as the Magic file. 

Creating bootmagic file... 

Using 'fscan' as the console interface tool... 

DS# 

4. Reset the Paragon system using the reset script with the ramdisk option. This script resets the 
nodes, resets the mesh, waits for the Node Confidence Tests (NCT) to complete, downloads 
bootmagic strings, and initiates booting. By default, it uses the serial line with the async utility. 
To exit async and return to the DS# prompt, enter the key sequence (or —. if you used rlogin 
to log into the diagnostic station). The key sequence ~q also works and does not require that you 
keep track of the number of remote logins. 

The <ramdisk> prompt appears when the Paragon RAM disk has been loaded. 

DS# ./reset ramdisk 


INIT: SINGLE-USER MODE 
<ramdisk> 

5. Execute the install script. 

<ramdisk> install 

This script asks you to verify or provide the information necessary to complete the installation. 
The script gets default values from existing configuration files, as well as from information 
gathered during previous installations. You should be prepared to provide the following 
information: 

Host name of the Paragon system 
DP address of the Paragon system 
Disk type of the Paragon system 

Netmask address of the Paragon system 
Broadcast address of the Paragon system 
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Gateway address of the Paragon system 

Host name of the distribution system 
IP address of the distribution system 

Pathname to the directory containing the installation tar files on the distribution system 
Login name and password on the distribution system 

6. The install script asks for the type and SCSI ID of the disk connected to the boot node on the 
Paragon system. 

The SCSI ID is a number between 0 and 6 and identifies the address of the disk on the SCSI 
controller. This number is usually ’O’ for a Paragon system with more than two backplanes. 

The script then lists the supported disk types. Press the <Enter> key to confirm the default value 
shown in square brackets (for example, [raid3]), or enter the correct value. For the disk type, 
you can enter the disk number (for example, ‘0’ for raid3), or you can spell out the name of the 
disk type (for example, “raid3”). If you specify an invalid number or name, the script detects 
the inconsistency with the disklabel and prompts you again for a choice, listing acceptable 
choices. 

Note that the script detects no difference between RAID3 and 5RAID5. If you have a RAID on 
your system, it will be set up as RAID3. If the drive is currently set up for RAID5, specify 
“raid3” when prompted for disk type, and it will be automatically converted from RAID5 to 
RAID3. 


Paragon Operating System Installation 
0.S. Install 


SCSI ID for Boot Disk: [0] 


0) 

raid3 

4.70 

Gigabyte 

Raid 

1) 

maxtor76 

0.76 

Gigabyte 

Maxtor 

2) 

maxtorl240 (non-raid) 

1.24 

Gigabyte 

Maxtor 

3) 

lgb (non-raid) 

1 

Gigabyte 

Drive 

4) 

4gbraid3 

4 

Gigabyte 

Raid Drive 

5) 

16gbraid3pfspg (raid) 

16 

Gigabyte 

Raid Drive 


-- OR 

-- 




Type in the disktab entry name for your 
boot device. (i.e. maxtor!240) 


Disk Type: [raid3] 
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The script then displays the information you have entered, and asks you to confirm it If the 
information is correct, press the <Enter> key, or enter ‘Y’ or 4 y\ These disk information 
prompts repeat until you confirm that the correct information has been entered. 

============== DISK information summary =================== 

Disk Type is "raid3" (Disk Label will be "raid3") 

SCSI ID 0 

Is this correct? (y/n)[y] 

If the disk is a RAID, the install script checks the configuration and performs the following 
actions: 

• If the RAID controller is not an NCR, the script generates an error message and exits. 

• If the status of the RAID controller is anything other than “Optimal” or “Degraded”, or if 
the RAID level is anything other than ‘3’, the script displays the following messages: 

WARNING: The RAID drives are either configured as RAID5, 
or are otherwise in need of initialization. This procedure 
will destroy any data currently on the drive. Do you want 
to continue? (y/n)[n] 

To proceed with the installation, you must enter 4 Y’ or 4 y’ to both questions, and the drive 
is initialized. If you enter anything else, the install script exits. 

7. The install script attempts to mount the root file system. 

A. If the root file system exists, the install script executes the fsck utility to clean it (if 

necessary). The file /root/etc/defaults/install is read to retrieve responses from a previous 
installation. If the file does not exist, reasonable defaults values are established. When the 
file is being read, the following message(s) is displayed: 

Mounting /dev/rzOa... 

Retrieving Previous Installation Responses ... Done. 

Even though the root file system exists, you may want to rebuild it to create a clean file 
system with no old files on it. The script displays the following prompt to ask if you want 
to rebuild the file system: 

A root file system has been detected on /dev/rzOa. 

It may not be necessary to rebuild it. If you do rebuild it, 
all files in the existing root file system will be 
destroyed 

Do you want to rebuild it? (y/n)[n] 
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If you press the <Enter> key, or enter ‘N’ or ‘n\ the installation proceeds without 
rebuilding the file system. If you enter ‘Y’ or 4 y\ the script asks for confirmation: 

Creating New Root File System. Okay? (y/n)[n] 

At this point, you must enter ‘Y’ or ‘y’ to rebuild the file system and proceed with the 
installation. Any other response terminates the installation. 

B. If the root file system does not exist, it will be created automatically. 

8. After the root file system has been mounted, the install script verifies the existence of the /usr, 
/etc,/etc/defaults, and /pfs directories, and creates them if they do not exist. 

If the /usr and /pfs file systems exist, you may want to rebuild either or both of them to create a 
clean file system with no old files on it. For each of these file systems, the install script displays 
a message asking if you want to rebuild an existing file system. A typical message is as follows: 

A pfs file system has been detected on /dev/rzOd. 

It may not be necessary to rebuild it. If you do rebuild it, 
all files in the existing pfs file system will be destroyed 
Do you want to rebuild it? (y/n)[n] 

If you press the <Enter> key, or enter ‘N’ or ‘n\ the installation proceeds without rebuilding 
the file system. If you enter ‘Y’ or ‘y\ the script rebuilds the file system and proceeds with the 
installation. 


9. Next, the install script asks you to verify the information needed to get the distribution files. If 
a /etc/defaults/install file was saved from a previous installation, the install script summarizes 
the file’s information and asks if it is correct. If /etc/defaults/install does not exist or has 
information missing, the script asks the needed questions. The following listing shows an 
example of the summary: 

RESPONSE SUMMARY ================ 

system 
00 . 00 . 00.00 
133.26.1.1 
255.255.255.00 
133,26.1.255 
para_ds 
133.26.15.5 
/u/tmp 
Y 


Node Name: 

IP Address: 
Gateway; 

Netmask: 
Broadcast: 
Distrib Node: 
Distrib IP Addr: 
Distrib Path: 
Create /home: 


Is the above information correct? (y/n)[n] 
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If you enter ‘Y’ or 4 y\ the installation proceeds using the default values. If you enter anything 
else, or if the /etc/defaults/install file was not found, the script displays a series of prompts for 
you to enter the information. The default value for each item is displayed in square brackets. 
Press the <Enter> key to select the default, or enter a new value. In the following example, the 
installer entered new values for “System Name” and “System IP Address”, and accepted the 
default values for the other items. 

System Name [system]: paragons 12 

System IP Address [00.00.00.00]: 133.26.101.31 

Gateway [133.26.1.1]: 

Netmask [255.255.255.00]: 

Broadcast Address [133.26.1.255]: 

Distribution Node Name [para_ds]: 

Distribution IP Address [133.26.15.5]: 

Distribution Path [/u/tmp]: 

Create /home File System [Y]: 

At the end of the questions, the script displays the new information in the response summary 
and asks again for confirmation. This sequence is repeated until you indicate that the response 
summary is correct. 

10. If you chose the create a new /home partition, the following question appears: 

All files in /home will be destroyed. Continue?[n] 

If you type n, the new /home partition is not recreated and the installation continues. Typey if 
you want to create a new /home partition. After typing y, the following message appears: 

Creating a new home file system... 

If the current /home partition is mounted, it is unmounted, and the following message appears: 

Unmounting /dev/rzOf... 

newfs -d 0 -b 8192 -f 2048 /dev/rrzOf 

11. The install script now sets up the network using the values you just provided. It then asks for a 
login name for ftp to use when getting files from the distribution system. The distribution 
system is the system from which you obtain the installation tar files. This may be the diagnostic 
station or one of your local servers. 

Username for FTP' ing files from Distribution Node Name : 

Enter a valid user name. The script then invokes ftp and attempts to use the name to log into the 
distribution node. When ftp prompts you, enter the user name’s password. The following files 
are retrieved from the distribution system: 
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root, tar 

mach_svr.tar 

usr.tar 

If the login is unsuccessful, the script displays an error message along with a request to verify 
the distribution information. 

ERROR: [file] was not retrieved. 

=========== DISTRIBUTION INFORMATION ============== 

Distrib Node: para_ds 

Distrib IP Addr: 133.26.15.5 

Distrib Path: /u/tmp 


Is the above information correct? (y/n) [y] 

Entering ‘n’ gives you the chance to change this information. If the information is correct, enter 
‘y’ and the script repeats the process of asking for a login name and password, and using ftp to 
get the distribution files. 

12. The remainder of the Paragon system installation is automatic, requires about 30 minutes to 
complete, and performs the following: 

• Obtains the installation tar files form the distribution system. 

• Preserves copies of ! etc/hosts, /etc/pas swd, / 'etc/exports, /etc/group, /etc/fstab, 
/etc/printcap, /etc/pfstab, / etc/devtab , /etc/services, /etc/resolv.conf\ /etc/ntp.conf 
/etc/shells , /etc/TIMEZONE, /va r/adm/sendmai l/se rid mail, cf, 
/var/adm/sendmail/sendmailcw, and /var/adm/sendmail/sendmail.st if they exist. 

• Restores the tar files that were retrieved from the distribution node. 

• Creates the default / etc/fstab, / etc/devtab, and /etc/rc.config files. 

• Restores copies of / etc/hosts, / etc/passwd , and / etc/exports, / etc/group, / etc/fstab , 
/etc/printcap, /etc/pfstab, and /etc/devtab if they exist. 

• Makes PFS directories. 

13. Depending on the type of your boot disk, the install script creates a 32M-byte or 64M-byte 
paging file for the default pager on the boot node. You will get better performance but use up 
more disk space with a larger paging file. The script now displays the defaults for your system 
and asks if you would like to create a larger paging file. 
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It puts this larger file on the home partition rather than the root partition. The following would 
be displayed for a RAID3. 

Default paging file size is 64M 
Bigger paging file size is 512M 

Would you like to make a bigger paging file in home 
partition?(y/n)[y] 

If you answer w, a default paging file is created on the boot node. This file is 
/ 'machjservers/pagingjile . Answer n if you want to use the default paging file and not create a 
bigger paging file. 

If you do not increase the size of the paging file now, you can still increase it after installation. 
Refer to “Increasing Default Paging File Size” on page 2-36 for information about how to do 
this. Refer to Chapter 12 the Paragon System Administrator's Guide for even more 
information. 

Also note that the install script puts the bigger paging file in /home. If you want your bigger 
paging file in a different partition, choose the default paging file and then follow the directions 
in the next step. 

If you currently have a bigger paging file, it’s most likely /home/paging_file. (Some users may 
chose a different location.) When this bigger paging file is used, /mach_ser\>ers/pagingjile is 
a link to /home/paging Jile. When you answer n, this link is broken, but /home/paging_file 
remains. After installation, you should delete /home/pagingjile to free up disk space. 

Answer y if you want to use an existing paging file. Also, answer y if you want to create a new 
paging file. If you answer y and a bigger paging file does not exist, the following message 
appears. 

Creating a paging file. It may take up to 15 minutes ... 
create__pf 512M /home/paging__file 

create__pf: Creating 'paging_file' of size (512 Meg) 524288 
blocks. 

If you answer y and a paging file already exists, the following question appears. 

A paging_file is in the home partition. Would you like to 
remake it again? (y/n) [n] 

Answer n if you want to use an existing bigger paging file. Answer y if you want to create a new 
bigger paging file. If you answer y, the following appears: 

Creating a paging file. It may take up to 15 minutes ... 
create_pf 512M /home/paging_file 

create_pf: Creating 'paging__file' of size (512 Meg) 524288 
blocks. 

When the <ramdisk> prompt returns, the installation is complete. 
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14. Perform this step if you want a bigger paging file but you do not want it in /home. This example 
assumes that you are placing the bigger paging file in /usr. Some users routinely backup all of 
/home, but do not wish to backup the paging file. The following instructions perform a reset. 
Note that the reset script automatically enters multiuser mode if the MAGIC.MASTER file 
contains RB_MULTIUSER=1. 

<ramdisk> mount -u / 

<ramdisk> fack -y / dev/rrzOa 
<ramdisk> mount -w /dev/rzOa /root 
<ramdisk> fack -y /dev/rrzOe 
<ramdisk> mount -w /dev/rzOa /uar 
<ramdisk> cd /uar 

<ramdisk> /root/abin/create_pf 512M paging_file 

<ramdisk> cbmod 600 paging_file 

<ramdisk> cd /root/dev 

<ramdisk> In ioO/rzOe rzOe 

<ramdisk> cd /root/mach_server8 

<ramdisk> mv paging__file paging__file.orig 

<ramdisk> /root/abin/In -s /dev/rzOe/paging_file paging_file 

<ramdisk> cd / 

<ramdisk> sync 
<ramdisk> unount /root 
<ramdisk> umount /uar 
<ramdisk> 

DS# ./reset 

When the reset command has completed and the prompt returns, enter multiuser mode by 
pressing <Ctrl-D>. 

15. When the <ramdisk> prompt appears, return to the diagnostic station prompt and use the reset 
command to reboot the Paragon system. Disconnect from the Paragon system RAM disk by 
typing (tilde period) or —. if you are logged in remotely to the diagnostic station. The key 
sequence ~q also works and does not require that you keep track of the number of remote 
logins.Then, invoke the reset command. 

<ramdisk> 

Exiting*... 

DS# 

DS# ./reset 


# <Ctrl-D> 

When the reset command has completed, the prompt that appears is on the Paragon system. 
Enter multiuser mode by pressing <Ctrl-D>. Note that the reset script automatically enters 
multiuser mode if the MAGIC.MASTER file contains RB_MULTIUSER=1. The root file 
system is checked and mounted and then the mesh is booted. 
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This step automatically brings up the remaining nodes on the mesh, using the /sbWbootmesh.sh 
script, which is called by /sbin/bcheckrc. The mesh will be booted just after the root file system 
is checked and mounted. Any nodes which fail to boot will be reported to the console; you can 
also look in the fi \t /etc/bootmesh.log for the list of failed nodes. 

If for some reason you need to boot with mesh booting disabled, add the string 

DISABLE_BOOTMESH=l 

to /usr/paragon/boot/MAGIC.MASTER on the diagnostic station. If you have booted with this 
string, you can later boot “by hand” by creating the Paragon system fil z /etc/.forcebootmesh, 
and executing /sbin/bootmesh.sh. 

When the system completes booting to multiuser mode, you can login again. If you have 
increased the size of the paging file and successfully booted to multiuser mode, you may delete 
the original paging file, /mach_servers/paging_file.orig. 


Executing the postboot Installation Script 

Run postboot for the final configuration, postboot updates the message of the day, sets the 
date/time, and optionally configures the network time daemon, prompts for compiler/documentation 
and tools installation, and creates the terminfo databases, spell dictionaries, cat directories, and lint 
libraries. 

If you intend to use postboot to install the compilers, you must have already read in the installation 
files from the compiler tapes. Refer to “Obtaining the Installation Files from Tape” on page 2-3 for 
instructions on how to read the distribution tape. 

To execute the postboot script, type the following: 

# cd / 

# ./postboot 

The script asks you to confirm the current date and time, and then prompts you before performing 
each of several tasks.. 


Postboot Process 

This script will perform final configuration of your Paragon system. 
Is this correct date/time: Sun Apr 27 10:30:36 PST 1947 (y/n) ? [y] 

23 

Enter date as yymmddhhmm 

$404270913 

Wed Apr 27 09:13:00 PDT 1994 
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The remaining tasks this script will perform are: 

- Configure Network Time Daemon 

- Install compilers and/or documentation 

- Install basic math libraries 

- Install Paragon tools 

- Install Paragon system acceptance tests 

- Create the terminfo databases 

- Create the spell dictionaries 

- Create the cat directories 

- Create the lint libraries 

Note: You must install the C compiler before 
the lint libraries can be created. 

Before each task is performed you will have the chance to 
choose if you want the task performed. 


The first task is to specify a network time daemon. Be prepared to provide the name of the computer 
that maintains your network-wide clock. 

Configure Network Time Daemon ... 

Do you wish to proceed with configuring network time daemon (y/n)? 

[y] 

n 

If you want to configuring the network time daemon, enter y. Note that the network time daemon 
adversely impacts performance because it sends messages to all the nodes in the system every five 
seconds. If you choosey, you get the message, 

What is name of your network time server? 
name of network time daemon 

A warning appears if you have already defined a network time daemon. If a warning appears and 
you want to change the definition, confirm that you want the daemon configured. 

Setting up network configuration file '/etc/ntp.conf' 

Starting the network time server ... 

Network Time Service started 


Installing compilers and/or documentation*.. 

Do you wish to proceed with installing compilers and/or 
documentation (y/n)? [y] 

y 
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If you want to skip installing the native compilers and the online documentation (manual pages), 
enter it. To install the compilers, you must have previously read in the compiler installation tar files 
onto the distribution node. If you answer y, the following menu is displayed. 


================= RESPONSE summary === 

Install C compiler and its docs: 
Install C++ compiler and its docs: 
Install FORTRAN compiler and its docs: 
Install system software documentation: 
Distribution Node: 

Distribution IP Addr: 

Distribution Path: 


Y 
N 

Y 

Y 


Distribution Node Name 
Distribution IP Addr 
Distribution Path 


Is the above information correct? (y/n)[n] y 


Answer n to change the defaults. 

Installing basic math libraries... 

Do you wish to proceed with installing basic math libraries (y/n)? 

[y )y 


If you want to skip installing the basic math libraries, enter n. To install the basic math libraries, you 
must have previously read in the libkmath.a, libkmathjr.a, and bml doc.tar.Z files onto the 
distribution node. If you answer y, the following menu is displayed. 

================= RESPONSE SUMMARY ==================:============= 

Distribution Node: Distribution Node Name 

Distribution IP Addr: Distribution IP Addr 

Distribution Path: Distribution Path 


Is the above information correct? (y/n)[n] y 
Answer n to change the defaults. 

Installing Paragon system tools... 

Do you wish to proceed with installing Paragon system tools (y/n)? 

[y]y 

If you want to skip installing the tools, enter n. To install the tools, you must have previously read 
in the tools installation tar files onto the distribution node. The standard Paragon system tools are 
on the tape labeled Paragon™ System Software Release 1.4. The Motif tools are on a separate 
release tape; refer to the Paragon ™ System Motif Graphics Library Release 1.2.4 Release Notes. 
The DGL and OpenDGL tools are also on a separate release tape; refer to the Paragon ™ System 
Silicon Graphics Libraries Release 2.0 Release Notes. 


2-18 













Paragon™ System Software Release 1.4 Installation Guide 


Software Installation 


If you answer y, the following menu is displayed 


================= RESPONSE summary === 

Install standard Paragon system tools: 
Install motif: 

Install dgl: 

Install opengl: 

Distribution IP Addr: 

Distribution Path: 


Y 

Y 

Y 

Y 

Distribution IP Addr 
Distribution Path 


Is the above information correct? (y/n)[n] y 

Answer n to change the defaults. If you choose to install the tools, appropriate online documentation 
is also installed. 


Installing system acceptance tests... 

Do you wish to proceed with installing system acceptance tests 
(y/n)? [y] y 


================= RESPONSE SUMMARY 

Distribution Node: 

Distribution IP Addr: 

Distribution Path: 


Distribution Node Name 
Distribution IP Addr 
Distribution Path 


Is the above information correct? (y/n/q)[n] 

Answer n to change the defaults. 

Creating terminfo databases.... 

Do you wish to proceed with creating terminfo databases (y/n)? [y ]y 
Running terminfo translator.... 


Creating spell dictionaries.... 

Do you wish to proceed with creating spell dictionaries (y/n)? [y] y 

Creating cat directories.... 

Do you wish to proceed with creating the cat directories (y/n) ? 

Cat directories will not be created. 
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If you choose to create the cat directories, note that this choice also creates the cat files. This choice 
takes a long time to execute and uses a great deal of disk space. 

The cat files are formatted versions of the online manual pages. Because it is quicker to access a 
formatted manual page than an unformatted one in / usr/share/man , some users choose to store cat 
files. However, if the cat directories exist and are empty, the first access to an online manual page 
places a formatted version in the appropriate cat directory. Hence, making empty cat directories 
results in, after a while, a collection of formatted files for the most frequently accessed online 
manual pages. This is preferable to making formatted versions of all online manual pages. 

If you choose to create the cat directories, you might see errors similar to the following, which can 
be ignored: unterminated list (no .LE) -- noticed by the . SH "RELATED". 

Creating lint libraries.... 

Do you wish to proceed with creating the lint libraries (y/n) ? [y] y 


NOTE 

To install C and Fortran cross compilers, refer to the Paragon™ 
System C Compiler Release 5.0 Software Product Release Notes 
and the Paragon™ System Fortran Compiler Release 5.0 
Software Product Release Notes. 


NOTE 

After postboot has successfully run, consider deleting the 
installation tar files from the distribution system. They will only be 
needed if you want to reinstall the operating system. 


After postboot has successfully run, remove any lingering patches by executing the following 
commands: 


# cd /etc/patches 

# rm -r R1.3 .* 

# rm README_R1.3.* 

# rm ParaBOM_Rl.3 . * 

# rm remove^Rl . 3 .* 
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Also remove the patch files from the diagnostic station. 

DS# cd /etc/patches 
DS# rm -r R1.3.* 

DS# rm README_R1.3.* 

DS# rm DiagBOM_Rl. 3. * 

DS# rxn ramove__Rl. 3. * 


Notifying the Users 

Now that the operating system is successfully installed, consider adding the following message to 
/ etc/motd : 


Release 1.4 of the Paragon system software has 
been installed on this system. All user 
applications must be recompiled and relinked 
before they can be run. 

PostScript copies of the release notes for 
Release 1.4 of the Paragon system software can be 
found in the directory /usr/share/release_notes. 
This directory also contains ASCII and PostScript 
copies of the current list of system software 
bugs. 


Configuring the Software 

After installing the operating system, you may want to perform some additional configuration steps. 


Configuring Online Documentation 

If you have installed any online documentation, you must make the whatis database. This is the 
database used by the man command with the -k option. To make the whatis database, issue the 
following commands: 

# cd /u sr/share/man 

# / usr/lbin/mkwhatis 

vnkwhatis does not successfully make the complete whatis file. It returns an error message that says 
“argument too long.” The same error message is returned by catman -w. The resulting whatis file is 
flawed but still usable. 

To allow other users to log into the Paragon system, remove the file / etc/nologin , if it exists. 

# rm /etc/nologin 
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Configuring the Allocator 

The allocator configuration file (called /etc/nx/allocator.config) sets limitations on what partitions 
can be created and what characteristics they have. When you create the partitions under the 
limitations set by the allocator configuration file, you use the mkpart command with appropriate 
options. 

initpart (run when the Paragon system enters multiuser mode) creates the default allocator 
configuration file, initpart also creates a new /etc/nx/.partinfo file if the current .partinfo has xy 
dimensions that are inconsistent with reality or the file does not exist. Finally, initpart makes the 
root partition with permissions 754 and sets the scheduling attribute to SPS, or space share. These 
permissions allow only root to create subpartitions. So when you are installing the system you need 
to take into account who you want to make partitions and where they can make them. 

The allocator configuration file sets the user model to allow for one gang-scheduled partition with a 
maximum of two NX applications per node and a minimum rollin quantum of 1 hour. The default 
/etc/nx/allocator.config file looks as follows: 

NUM__GANG__PARTS = 1 
DEGREE_OF_OVERLAP=2 
MIN_RQ_ALLOWED=lh 

You can disable any of these values by removing the appropriate variable from 
/ etc/nx/allocator. config. 

If you remove the file, it will be created with defaults at the next boot. If you want to remove 
constraints on the user model, comment out the appropriate lines. Indicate a comment by putting a 
# in the first position of the line. 


NOTE 

You should not use the -tile option on the allocator line in 
/sbin/init.d/allocator. Use the allocator.config file instead. Refer to 
the allocator.config manual page in the Paragon™ System 
Commands Reference Manual. 


To have any changes to the configuration file take effect you will need to stop and restart the 
allocator after the changes are made. To stop and start the allocator, issue the allocator command. 

# /sbin/init.d/allocator stop 

# /sbin/init.d/allocator start 
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Configuring the .service and .compute Partitions 

The following example shows how to create the serxnce and compute partitions. The example 
assumes a 64 node system with the boot node at node 7 and additional MIO nodes at nodes 15 and 
23. These are OS node numbers. 


CAUTION 


The .service partition must contain the boot node. 


Create the sennce partition. Use the -ss switch, so the service partition has standard scheduling. The 
following example allocates nodes 7, 15, and 23 to the service partition. 

# mkpart -nd 7,15,23 -ss .service 

Create the compute partition using the -sz switch to allocate the remaining 61 nodes to the compute 
partition and the -mod switch to set permissions that enable all users to create subpartitions in the 
compute partition. Note that you may want to change the permissions of the compute partition when 
you personalize your configuration. 

# mkpart -sz 61 -mod 771 .compute 

After creating the compute partition, issue the showpart command to display the nodes that are 
allocated to each partition. Verify that the partitions do not overlap (that is, each node is allocated to 
only one partition). For example: 

# showpart .compute 

# showpart .service 

If the partitions do overlap, use the rmpart command to remove the overlapping partitions. When 
you use mkpart to create the partitions again, you may need to use the - nd switch to specify the node 
numbers of the nodes to include in the compute partition. For example: 

# rmpart * compute 

# mkpart -nd 0..5,8..14,16..22,24..63 -mod 777 .compute 

Notice that this example did not specify any scheduling characteristics. If you do not specify a 
scheduling characteristic when making a partition, then the characteristics are inherited from the 
parent. In the case of the. compute partition, the default is space-shared and no gang-scheduling. To 
explicitly set the .compute partition to be gang-scheduled, you must specify a rollin quantum value 
with the -rq switch. (0 is valid, and means an application will run to completion). For example, 

# mkpart -sz 61 -rq 0 -mod 777 .compute 
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Configuring the Autoreboot Feature 

If you already have the operating system installed and you are installing it again or installing a later 
version, there is no need to reconfigure the autoreboot feature. Re-installation does not change the 
contents of /usr/paragon/boot/fscan.cfg, where the autoreboot information is stored. 

In the file / usr/paragon/boot/fscan.cfg , 

set autoreboot on indicates that the autoreboot feature is on. 

set autoreboot off indicates that the autoreboot feature is off. 

The automatic reboot feature is enabled by default. When this feature is enabled, the Paragon system 
reboots whenever it stops functioning normally or is intentionally shutdown. 

Turn off the autoreboot feature before performing hardware maintenance. To turn off autoreboot, 
log into the diagnostic station. 


Configuring the Time Zone 

If your Paragon system arrived with the software already installed, you might need to modify the 
/etc/TIMEZONE and /etc/rc.config files on the Paragon system to reflect your time zone. You may 
also need to modify these files if you have reinstalled the Paragon system software. 


Configuring a Paging Tree 

If you have several I/O nodes, consider setting up a paging tree. Without a paging tree, all nodes 
page to the boot node, and for large systems, this can be inefficient. A paging tree is a way of 
configuring some or all of a system’s I/O nodes as pagers to minimize the impact of paging on any 
one node. You can set up an automatic paging tree (a standard configuration), or you can configure 
the tree manually. Refer to the Paragon System Administrator's Guide for a detailed discussion of 
paging trees and for information about how to set one up. 


Automatic Generation of Paging Trees 

You can have a default paging tree automatically generated by editing the reset script. The 
Paragon System Administrator's Guide explains how to edit the reset script to allow for the 
automatic generation of paging trees. Note, however, that after installation a new reset script is 
installed. If you want to retain automatic paging tree generation, you must edit the reset script again. 
To ensure that you install the latest software, do the re-edit rather than save and restore your old reset 
script. 
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Configuring the Paragon™ System for the Network 

If your Paragon system arrived with the software already installed, you must change the network 
name and IP address of the diagnostic station and the Paragon system to bring them up on the 
network at your site. If you are reinstalling or upgrading the system software, you should only need 
to reconfigure the Paragon system. Refer to “Installing Boot Files on the Diagnostic Station” on page 
2-4 for information about configuring the diagnostic station for the network. 

If your Paragon system has any HIPPI boards installed, you must configure their network interface 
when you first receive the system, and also whenever the system software is installed or upgraded. 
HIPPI configuration includes activating the network interface and specifying the HIPPI routing 
tables. For a complete description of this procedure, see the Paragon M System High Performance 
Parallel Interface Manual. 

1. Edit th e/etc/rc.config file, and change HOSTNAME and HOSTID (IP address) to the new 
values. 

2. Verify that the /etc/hosts file has entries for the Paragon system network ID (IP number) and 
diagnostic station network ID. 

3. If you are using the domain nameserver, edit /etc/resolv.conf Set the value for the domain and 
add nameservers if needed. 


Configuring an Additional Ethernet Board 

Every Paragon system has at least two ethernet connections, one to the diagnostic station and one to 
the boot node. Follow these instructions if you have another Ethernet connection to an I/O node other 
than the boot node. This makes for a total of three Ethernet connections, but because this is a second 
Ethernet connection to the Paragon system nodes, these instructions are often referred to as those for 
configuring a second Ethernet. 

1. Log in or rlogin to the diagnostic station as root. 

2. Change directory to /usr/paragon/boot. Edit DEVCONF.TXT to contain a line identifying the 
position of the s'econd Ethernet connection. 

For example, consider a two-cabinet configuration with one Ethernet connection. This 
connection is on the boot node which is in cabinet 0, backplane D and slot 3. The CBS number 
of the boot node is 00D03. Now assume that you add a second Ethernet connection to a new I/O 
node in cabinet 1, backplane A, and slot 12. Its CBS number is 01A12. 
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A typical DEVCONF.TXT file is shown below. The lines in bold are those added for the new 
I/O node with the Ethernet connection. 

DEVICES 
ENET 00D03 

ENET 01A12 

RAID 00D03 ID 0 SW 3.02 LV 3 DC 5 SID 0 RAID3 
TAPE 00D03 ID 6 DAT 
MIC 00D03 H04 

MIO 01A12 H04 

END^DEVICES 

3. Connect to the Paragon system with the console command. 

DS# cd /usr/paragon/boot 
DS# •/console 


login: 

4. Edit the /etc/hosts file to include the new interface, using the additional IP address and 
additional host name. 

5. Edit the file / etc/rc.config . Define HOSTNAME2, HOST1D2 and NETDEV2 and export their 
values. 

HOSTNAME=j oe 

HOSTNAME2-frank 

HOSTID=xxx.yy.z z.aaa 

HOSTID2 =xxx.yy.z z.bbb 

NETMASK=2 55.255.255.00 
NETDEV = " < 7 > emO" 

NETDEV2 * " < 9 6 > emO" 


export DISPLAYTYPE HOSTNAME HOSTNAME2 HOSTID HOSTID2 NETMASK 
NETDEV NETDEV2 TZ 

The NETDEV variable identifies the node number of the Ethernet connection. Each Ethernet 
connection has its own HOSTNAME and HOSTID. It is not necessary to define a NETMASK2 
if the second Ethernet connection is on the same class as the primary and uses the same mask 
value. 
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Login as root to the Paragon system and edit the file /sbin/init.d/inet. The lines in bold indicate 
the lines that must be added to configure a second Ethernet board. Both are ifconfig lines. Note 
that the ifconfig line for the second Ethernet board must appear above the line for loopback: 
/sbin/ifconf ig loO 127.0.0.1. This is true for all network devices, including a 
HIPPI controller. 


if [ "$ARGTWO" = "force" -o "$9" = "S" ]; then 
echo "Configuring network" 
echo "hostname: \c" 

/shin/hostname $HOSTNAME 
/sbin/hostid $HOSTID 
echo "hostid: $HOSTID" 

/sbin/ifconfig $NETDEV $HOSTID netmask $NETMASK -trailers 

# ifconfig second ethemet 

/sbin/ifconfig $NETDEV2 $HOSTID2 netmask $NETMASK -trailers 

/sbin/ifconfig loO 127.0.0.1 

# 


# Add default routes; start routed 


# 

# 

# 

# 

fi 
/ / 

' stop') 


echo "Adding route for osfgw: " 

SUBNET='expr $HOSTID : ‘ ‘ ' 
/sbin/route add default 137.27.$SUBNET.1 
/sbin/route add default $GATEWAY 


/sbin/ifconfig $NETDEV2 down 

/sbin/ifconfig $NETDEV down 
/sbin/ifconfig loO down 


6. Unmount all file systems listed in / etc/fstab , and use the halt command to shut down the 
Paragon system. Then, return to the diagnostic station prompt by typing (or —. if you are 

logged in remotely to the diagnostic station). The key sequence ~q also works and does not 
require that you keep track of the number of remote logins. Then, issue reset with the autocfg 
option. This ensures that the new information in DEVCONF.TXT is added to SYSCONFIG.TXT. 


# cd / 

# sync;sync;sync 

# shutdown now 

# uaount -A 

# halt 

# 

DS# ./reset autocfg 

DS# 
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7. Reset the Paragon system and enter multiuser mode. When the reset command has completed 
and the prompt returns, enter multiuser mode by <Ctrl-D>. Note that the reset script 
automatically enters multiuser mode if the MAGIC.MASTER file contains 
RB_MULTIUSER=1. 

DS# ./reset 


# <Ctrl-D> 


Configuring the System for HIPPI 

Refer to the Paragon ™ System High Performance Parallel Interface Manual for instructions on how 
to configure your system for a HIPPI controller. 


Configuring the PFS 

This section provides instructions for configuring a Parallel File System (PFS). The operating 
system installation process configures and mounts a default PFS file system as specified in the 
default versions of the /etc/fstab and /etc/pfstab files. 


The Default / etc/fstab File 

The /etc/fstab file contains entries for file systems and disk partitions to be mounted at boot time. 
The /etc/pfstab file contains definitions of the stripe groups. A stripe group consists of stripe 
directories where the actual PFS files reside. 

The default configuration may not be the best configuration for your system. The default 
configuration is provided as a template that you can modify for your particular configuration. 


NOTE 

Running with the PFS . striped across the boot node is not 
recommended, unless, of course, you have only one I/O node and 
it is the boot node. 


The default configuration assumes that you have one I/O node. It mounts /, /usr, and /home as UFS 
partitions. It mounts /pfs as the PFS partition with stripe group one. The mounts are shown in 
/ etc/fstab , and the stripe groups are defined in / etc/pfstab . 
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When looking a t/etc/fstab, note that ioO has partitions rzOa, rzOb , rzOc, rzOd . rzOe , rzOf, and rzOg. 


• The partitions rzOb, rzOc, and rzOg are not mounted. They are not mentioned or commented out 
in / etc/fstab. 

• The partitions rzOa , rzOe, and rzOf are UFS file systems. is the root partition /; rzOe is the 
user partition /usr, and rzOf is the home partition /home. This information is embodied in the 
following lines from /etc/fstab. 


/dev/ioO/rzOa / 
/dev/ioO/rzOe /usr 
/dev/ioO/rzOf /home 


ufs rw 0 1 
ufs rw 0 2 
ufs rw 0 3 


• The partition rzOd is the mount point for the PFS file system, and its stripe group is one. This 
means that /etc/pfstab must have the stripe group one defined. This information is embodied in 
the following line from / etc/fstab. 


/dev/ioO/rzOd /pf s 


pfs rw,stripegroup=one 0 3 


In summary, 


rzOa 

UFS, mounted, root partition 

rzOb 

not mounted 

rzOc 

not mounted 

rzOd 

mount point for PFS 

rzOe 

UFS, mounted, user partition 

rzOf 

UFS, mounted, home partition 


Here is the complete text of the default /etc/fstab. The # at the start of a line indicates a commented 
line. 


# Local (required to boot mesh) filesystems 

44 


Tr 

/dev/ioO/rzOa 

/ 

ufs 

rw 

/dev/ioO/rzOe 

/usr 

ufs 

rw 

TT 

# Additional local filesystems 

44 . 



TT 

/dev/ioO/rzOf 

44 

/home 

ufs 

rw 

TT 

# Remote filesystems 



#/dev/iol/rzOc 

/home/.sdirs/volO 

ufs 

rw 

#/dev/io2/rz0c 

/home/.sdirs/voll 

ufs 

rw 

#/dev/io3/rz0c 

/home/.sdirs/vo!2 • 

ufs 

rw 

#/dev/io4/rzOc 

/home/.sdirs/vol3 

ufs 

rw 


# 


0 

0 


0 


0 

0 

0 

0 


1 

2 


3 


4 

4 

4 

4 
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# Parallel filesystems 

# 

/dev/ioO/rzOd /pfs pfs rw,stripegroup=one 05 

# 

# NFS filesystems 
#' 


The Default / etc/pfstab File 

When looking at the default /etc/pfstab, notice there are nine stripe groups defined. The stripe groups 
eight and all are the same. Please note that the names one through eight are only examples. You can 
use any group names you like. 

Note first that / home is mounted on partition rzOf The stripe group one consists only of the directory 
lhome/sdirs/volO because one is only on that line. The stripe group two consists of the directories 
(i Ihome/sdirs/volO and /home/, sdirs/vol 7 )e. 

Here is the default /etc/pfstab. 


/home/.sdirs/volO 

all one 

two 

three 

four 

five 

six 

seven 

eight 

/home/.sdirs/voll 

all 

two 

three 

four 

five 

six 

seven 

eight 

/home/.sdirs/vol2 

all 


three 

four 

five 

six 

seven 

eight 

/home/.sdirs/vol3 

all 



four 

five 

six 

seven 

eight 

/home/.sdirs/vol4 

all 




five 

six 

seven 

eight 

/home/.sdirs/vol5 

all 





six 

seven 

eight 

/home/.sdirs/vol6 

all 






seven 

eight 

/home/.sdirs/vo!7 

all 







eight 


Even with one I/O node, it may make sense to have two stripe directories. This is because a stripe 
directory is in a UFS file system and cannot contain files larger than 2G-1 bytes. For PFS files to be 
larger than 2G-1 bytes, they must be striped across more than one stripe directory, and each stripe 
directory must be a separate file system. Then, the portion of a PFS file in a stripe directory is always 
less than 2G-1 bytes while the entire file may be larger. 


Additional I/O Nodes 

When you configure the PFS, you may choose to have different I/O nodes used by the PFS and the 
paging tree. To specify that an I/O node is not to be used by the paging tree, add the NOPAGER 
token to the RAID line in DEVCONF.TXT. Then, perform a reset autocfg. For example, the 
following line shows how to identify the I/O with CBS number 00D01 as an I/O node that will not 
be used for paging. 

RAID 00D01 ID 0 SW 3.02 LV 3 DC 5 SID 0 RAID-3 NOPAGER 
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To configure additional I/O nodes for PFS, 

1. Follow the instructions in the previous section under “Configuring the PFS” on page 2-28 to 
configure file systems on I/O nodes other than the boot node. 

The partitioning of the RAID subsystem is determined by the disk label. Choose either the 
non-boot *pfs label or the non-boot *pfspg label. 

2. Uncomment or add the appropriate entries in /etc/fstab. For example, if four I/O nodes are added 
for PFS file striping, the /etc/fstab entries might be changed to the following: 


# Local (required to boot mesh) filesystems 

# 


/dev/ioO/rzOa / 

/dev/ioO/rzOe /usr 
# 

# Additional local filesystems 

# 

/dev/ioO/rzOf /home 


# Remote filesystems 

/dev/iol/rzOc /home/.sdirs/volO 
/dev/io2/rz0c /home/.sdirs/voll 
/dev/io3/rz0c /home/.sdirs/vol2 
/dev/io4/rz0c /home/.sdirs/vo!3 


# 

# Parallel filesystems 

# 


ufs rw 0 1 
ufs rw 0 2 


ufs rw 0 3 


ufs rw 0 4 
ufs rw 0 4 
ufs rw 0 4 
ufs rw 0 4 


/dev/ioO/rzOd /pfs pfs rw,stripegroup=four 0 5 

# 

# NFS filesystems 


The difference from the default /etc/fstab is that the remote file systems are uncommented and 
the stripe group has been changed to four. 


The new configuration has the following consequences: 

• The stripe group of the PFS mount has been changed from one to four. Files created in /pfs will 
be striped across stripe group four , which is defined in /etc/pfstab to consist of the directories 
/home/. sdirs/volO, /home/.sdirs/voll, /home/sdirs/vol2, and /home/, s dirs/v ol3. Because each of 
the stripe directories is the mount point of a UFS file system on a different I/O node, concurrent 
striping to four I/O nodes is achieved. 

• PFS files are not striped across the boot node, ioO. 
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• 2G-1 bytes of each RAID subsystem are used. This is because the stripe directory is mounted 

on a UFS file system, which has a limit of 2G-1 bytes. This means that maximum use of the data 
storage capability of the RAID subsystems for PFS use is not attained. However, concurrency 
is maximized. 

If you decide to have two stripe directories per RAID subsystem, the remote mounts in /etc/fstab 
might look as follows: 

# 

# Remote filesystems 

# 

/dev/iol/rzOc /home/.sdirs/volO ufs rw 0 4 
/dev/io2/rzOc /home/.sdirs/voll ufs rw 0 4 
/dev/io3/rzOc /home/.sdirs/vol2 ufs rw 0 4 
/dev/io4/rz0c /home/.sdirs/vol3 ufs rw 0 4 

# 

/dev/iol/rzOd /home/.sdirs/vol4 ufs rw 0 4 
/dev/io2/rz0d /home/.sdirs/vol5 ufs rw 0 4 
/dev/io3/rz0d /home/.sdirs/vol6 ufs rw 0 4 
/dev/io4/rz0d /home/.sdirs/vol7 ufs rw 0 4 

# 

# Parallel filesystems 

# 

/dev/ioO/rzOd /pfs pfs rw,stripegroup=eight 0 5 

With Release 1.4, a file write randomly chooses the stripe directory it starts with and then is 
sequential and cyclic. For example, assume that you are doing a 128K-byte write. The stripe unit by 
default is 64K. Assume that the write randomly begins on /home/.sdirs/vol7 . The first 64K bytes go 
to io4, and the second 64K bytes go to iol (because the access is cyclic). 

The stripe directories must be owned by root and have write/execute permissions for root , 
write/execute permissions for group and other , and have their sticky bits set. The PFS mount point 
must have read/write/execute permissions for everyone and have its sticky bit set. 

The file systems must be mounted before you can change their ownership or permissions. To mount 
the file systems listed in /etc/fstab , issue the following command: 

# mount -a 

The commands to set the ownership and permissions are as follows (the leading 1 sets the sticky bit): 

# chown root stripejdirectoriues 

# chmod 1333 stripe jdirectoriues 

The command to do this is as follows: 

# chmod 1777 mountjpoint 
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Configuring MACS 

If you will be running MACS at your site, refer to Chapter 4 of the Paragon ™ System Multi-User 
Accounting and Control System Manual for setup and configuration instructions. 

The MACS database format is the same in Release 1.4 as in Release 1.3. The dbconvert program is 

TM 

still provided for Release 1.2 data. Refer to the Paragon System Multi-User Accounting and 
Control System Manual for information about dbconvert. 


Configuring NQS 

If you will be running NQS at your site, refer to Chapter 5 of the Paragon™ System Nework 
Queueing System Manual for setup and configuration instructions. 

If you are upgrading from Release 1.3 to Release 1.4, you must convert the NQS queues files. You 
can do this by running the NQS setup script (/ usr/lib/nqs/setup/nqs_setup ), or by running the 
nqs_queue_upgrade command (/usr/lib/nqs/setup/nqs_queue_upgrade) manually. The 
nqs_queue__upgrade command updates the pre-Release 1.4 NQS queues database files to the R1.4 
format. Your old queues database files are saved with the extension .bak. 

If you stopped NQS queues before beginning the installation of the operating system, restart them 
now. To do this, enter the NQS qmgr, and issue the start queue command. 

Mgr: start queue q!6-30 

NQS manager [TCML__COMPLETE ] : Transaction complete at local host. 


Post-Installation Tasks 


This section describes some tasks that you may want to perform after installing the operating system. 

For example, assume that when running postboot , you decided not to install the system acceptance 
tests. This section contains instructions on how to install those tests manually. 

As another example‘consider the paging file. After installation, you may choose to change its size,; 
most likely you want to increase it. This section contains instructions on how to do that. 

Resetting the System After Installation 

Resetting the Paragon system, once it is up and running, is performed as follows; 

1. Log in or rlogin to the diagnostic station as root. 
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2. Connect to the Paragon system with the console command. The console command is a script 
that the reset script created in Ausr/paragon/boot the last time reset was run. console uses 
whatever the console connection was at the time and supports the async, fscan, and the scanio 
console interfaces. You may have to press a carriage return after issuing console to get a prompt. 

DS# cd /usr/paragon/boot 
DS# ./console 


login: 

3. Login as root to the Paragon system, unmount all file systems, and use the halt command to 
shut down the Paragon system. Then, return to the diagnostic station prompt by typing (or —. 
if you are logged in remotely to the diagnostic station). The key sequence -q also works and 
does not require that you keep track of the number of remote logins. Then, use the reset script 
to reboot the system. 

# cd / 

# sync;sync;sync 

# shutdown now 

# umount -A 

# halt 

# 

DS# ./reset 


# <Ctrl-D> 

When the reset command has completed and the prompt returns, enter multiuser mode by 
pressing <Ctrl-D>. Note that the reset script automatically enters multiuser mode if the 
MAGIC.MASTER file contains RB_MULTIUSER=1. 

When you boot the system, the fsck command is automatically run on each file systems defined in 
/ etc/fstab (such as/home./pfs and the PFS stripe directories typically mounted on /home/.sdirs/vol*). 

In the case of a severely damaged file system, the fsck will fail and a message will be displayed to 
the screen. The message will scroll off the screen before the reboot is complete and you may not 
notice it. The system will continue to boot to a multi-user state with no other indication that anything 
is wrong. 

If the fsck fails, the affected file system will not be mounted. Any files written to the unmounted file 
system are written into the file system containing the desired mount point instead. Later, if you 
notice that a file system did not mount and you fsck and mount it, the files that were written into the 
root file system become hidden. To avoid this problem, after each boot you should manually 
compare the mounted file systems with the contents of the fstab file. Make sure that the PFS stripe 
directories are mounted or the fsck data will go into the /home file system. 
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For example, assume that fsck failed when processing the PFS stripe directories and that these stripe 
directories are mounted on the partition /dev/ioJ/rrzOc. To manually run fsck on this partition, enter 

# fsck -y /dev/iol/rrzOc 

The -y directs fsck to answer yes to all its questions. 


TM 

Installing the Paragon System Acceptance Tests 

These instructions assume that you have copied the compressed tar files from the distribution tape 
to the diagnostic station or to some other server. 

1. Log in to the Paragon system as root . 

2. Establish an ftp connection with the server containing the files, sat.tar.Z and sat.doc.tar.Z. 

# cd /tmp 

# ftp IP address of server with distribution files 
Name: login_name 

Password: password 

ftp> cd path to distribution files 

ftp> bin 

ftp> get sat.tar.Z 
ftp> get sat.doc.tar 

ftp> bye 

3. Use the following steps to uncompress and untar the distribution files into the / directory. 

# uncompress sat.tar.Z 

# cd / 

# tar xf /tmp/sat.tar 

# rm /tmp/sat.tar 

# cd /usr/share 

# tar xf /tmp/sat.doc.tar 

# rm /tmp/sat.doc.tar 

If you are having disk space problems, use zcat to uncompress and extract. This uses less space, 
but takes longer; 

# cd / 

# zcat /tmp/sat.tar.Z | tar xvf - 

# rm /tmp/sat.tar.Z 

# cd /u sr/share 

# tar xf /tmp/sat .doc. tar 

# rm /tmp/sat.doc.tar 
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Before running the SATs, you must configure a Parallel File System (PFS). Refer to “Configuring 
the PFS” on page 2-28 for instructions on configuring a PFS. 


Increasing Default Paging File Size 

By default, the install script creates a 64M-byte paging file for the default pager on the boot node. 
If you want to increase the size of the paging file after installation, follow the instructions in this 
section. 

If the system produces an error similar to Paging File Exhausted, it could indicate the paging file is 
too small. The following procedure shows how to increase the size of the paging file. 

The example shown here increases the size of the paging file to 512M bytes. The new paging file is 
placed in the Ihome partition because the /root partition is not large enough for such a file. Some 
users may elect to put the paging file in the /usr partition. 


Note 

Increasing the size of the paging file to 512M bytes can take up to 
thirty minutes. A smaller page size will take less time. Before you 
increase the size of the paging file, you should ensure that there 
is enough room in the home partition. 


1. Log into the Paragon system as root. Create the paging file in the home partition. 

# / sbin/create_pf 512M /home/paging^ file 

2. You also need to make a symbolic link from the old paging file in the root partition to the new 
paging file in the home partition. But the microkernel has difficulty following a symbolic link 
to the home partition /dev/ioO/rzOf. So you need to make a hard link from /dev/ioO/rzOf to 
/dev/rzOf. 

# In ZdSv/ioO/rzOf /dev/rzOf 

3. Shutdown the Paragon system. 

# cd / 

# sync; sync; sync 

# halt 

# ~q 
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4. The shutdown returns you to the diagnostic station prompt. Reset to single-user mode. Note that 
the reset script automatically enters multiuser mode if the MAGIC.MASTER file contains 
RB_MULTIUSER= 1 . 

DS# ./reset 

5. Now, on the Paragon system, make the root partition writable, save the original version of the 
paging file, and then make a symbolic link between the new paging file and the old one. 

# mount -u / 

# mv /aach_servers/paging_file /mach__servers/paging_file .orig 

# In -s /dev/rzOf/paging_file /mach_server8/paging_file 

6. Reboot the Paragon system to multiuser. If there is any problem with the new paging file, the 
system may complain about not being able to find the paging file. It then prompts for the paging 
file’s name. If that happens, enter /mach_servers/paging JUe.orig to boot the system. Once the 
system has no problem booting with the new paging file, you may remove 
/mach_servers/paging_file.orig. 




2-37 



Software Installation 


Paragon™ System Software Release 1.4 Installation Guide 



2-38 




Index 



A 

additional I/O nodes 2-30 
allocator 2-22 
autocfg 2-7 
autoreboot 2-24 

B 

backplanes 1-9 
backup 1-7 

backup, recommended files and directories 1-1 
boot.tar 2-2, 2-4 
BOOT.CONSOLE 1-5, 1-6 
BOOT_FIRST_NODE 1-5 
BOOT_GREEN_LED 1-5 
BOOT_RED_LED 1-5 
BOOT_VM_PAGESIZE 1-6 
broadcast address 1-2 
buildscan 2-5 


CBS numbering 1-8 
compilers 2-20 
compute partition 2-23 
configuration files 1-4 
console command 2-26 
crstools.tar.Z 2-2 
CTRLO 1-5 
CTRL1 1-5 
CTRLn 2-7 

D 

DEGREE_OF_OVERLAP 2-22 
DEVCONF.TXT 1-4, 2-7, 2-25, 2-30 
diagnostic software 2-2 
diagnostic station 1-4,2-4 
disk space requirements 1 -2 
distribution tapes 2-3 
doc.tar.Z 2-2 


C E 

cabinet numbering 1-9 ethernet 1-3, 2-25 

cat files 2-20 


Index-1 




Index 


Paragon™ System Software Release 1.4 Installation Guide 


F 

fscan 1-6 
fstab 2-28 

G 

gateway address 1 -2 

H 

HIPPI 2-25, 2-28 
HOSTID 2-25 
HOSTNAME 2-25 


mkpart 2-23 
motd 2-21 

N 

netmask address 1-2 
network configuration 2-25 
network information 1 -2 
network time server 1-2 
node numbering 1-8 
NOPAGER 2-30 
NQS 2-7, 2-33 
NUM_GANG_PARTS 2-22 


I 

information needed for installation 1 -2 

initpart2-22 

install 2-8 

installation files 2-3 
installation medium 2-2 
installation time 2-2 

L 

LEDs 1-9 

M 

mach_svr.tar 2-2 
MACS 2-22, 2-33 
MAGIC.MASTER 1-4, 1-5,1-8 
MAGIC.md 1-4 
MIN_RQ_ALLOWED 2-22 


0 

ODT1-4 

online documentation 2-21 
Open Desk Top 1-4 
OS numbering 1-8,1-10 

P 

PAGE_TO 1-5 
paging file 2-36 
paging tree 2-24 
PARA_ALIAS 2-6 
Paragon disk type 1-2 
Paragon host name 1 -2 
Paragon Internet address 1-2 
patches 2-20 
PFS 2-28 
pfstab 2-30 


lndex-2 



Paragon™ System Software Release 1.4 Installation Guide 


Index 


9 


postboot 2-16 
PostScript copies 2-21 
powering up 1-3 

Q 

que_update 2-7 

R 

RAID 1-5 
RAID3 2-9 
RAID5 2-9 
ramdisk 2-8 

REAL_FIRST_NODE 1-6 
reset 1 -6, 2-34 
rmpart 2-23 
root.tar 2-2 

RST_CONFIGURATION 1-6 
RST_TOP_BACKPLANE 1-6 
rzOb 1-5 

s 

sat.doc.tar 2-2 

sat.tar.Z 2-2 

SCO UNIX 2-3 

SCSI ID 2-9 

SCSI-16 1-5 

service partition 2-23 

showpart 2-23 

slot numbering 1-9 

SYSCONFIG.TXT 1-4, 1-8 

system acceptance tests 2-35 


T 

tile 2-22 

TIMEZONE 1-7, 2-24 
tools.doc.tar.Z 2-2 
tools.tar.Z 2-2 

typesetting conventions, additional 1-1 

U 

UNIX 2-5 
usr.tar 2-2 

V 

virtual terminal facility 1-4 


lndex-3 



Index 


Paragon™ System Software Release 1.4 Installation Guide 





